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Presentation 

This technical report describes the implementation of exact and parametrized exponential algorithms, developed 
during the French ANR Agape during 2010-2012. The developed algorithms are distributed under the CeCILL 
license and have been written in Java using the Jung graph library. 



1 Installation notes 

The source code is available at http://traclifo. univ- or leans . f r /Agape l\ Several dependencies 
are necessary in order to use the Agape library. They are included in the lib/ directory of the SVN trunk: 

• Jung library 2.0.1 BSD license (jung*. jar). 

Apache commons for collections Apache License 2.0 (collect ions-generic-4 . 01 . jarj^ 



Guava i.e. Google's collections Apache License 2.0, (guava-r09 . jar). 



Mascopt optimization library, LGPL, (mascoptLib . jar). 



The project can be downloaded as an Eclipse project from the SVN trunk repository (see instructions on the 
website). It is particularly useful for studying the source code of the provided algorithms. To use this library as a 
dependency in another project, only the agape.jar file and the dependencies (dependencies.zip) are needed. 



2 Packages content 

In this section, we briefly describe the implemented algorithms. Section [3] describes how to use these algorithms 
through simple tutorials. 



2.1 Package agape.algos 

This package contains the different implemented exponential or parametrized algorithms. The abstract class 
Algorithms groups the different factories for graph/vertices/arcs creation. The graphs are based on generic 
classes of the Jung library. Indeed, some algorithms require to instantiate vertices or arcs. The instanciation of 
such objects depends of the nature of the generic token, e.g. a vertex can be an Integer. Thus, as the type 
of vertices are not known in advance, the algorithms that require to create graphs should obtain a factory for the 
provided graph. 

The different classes and their hierarchy are represented in Figure [T] Table [T] sums-up the different imple- 
mented algorithms, their complexity in time and the references to the papers that provided the algorithms. The 



last column recalls the acronym used for the Agape Command Line tool (c.f. Section 2.2.2 1. In the following 
subsections, each implemented algorithm is briefly described. 



2.1.1 Class Coloring 

The goal of this class is to compute the minimum number of colors to properly color an undirected graph. 

int chromaticNumber(Graph<V,E> G): Computes the chromatic number of a graph G. This method is based 
on the An exact algorithm for graph coloring with polynomial memory by Bodlaender and Kratsch |4|. The 
algorithm solves the problem in PSPACE and in time 0(5.283"). 

Set<Set<V> > graphColoring(Graph<V,E> G): Computes a solution having the minimum chromatic number 
using the same algorithm as before. It returns the partition of the vertices into color classes. 

Set<Set<V> > greedyGraphColoring(Graph<V,E> G): a greedy algorithm that computes iteratively the maxi- 
mum independet set of G and removes it. 

1 This is a new (very old i.e. 2006) version of the popular Jakarta Commons-Collections project. It features support for Java 1 .5 Generics. 
Generics introduce a whole new level of usability and type-safety to the Commons-Collections classes. 
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Acronym 


Algorithm 


Time complexity 


References 


Agape CL 


CN 


Chromatic Number 










Bodlaender, Kratsch 


0(5.283") 


1 A 1 




DFVS 


Directed Feedback Vertex Set 










Razgon, Thomasse 


0(1.9977 ) 


n 1 /i 1 1 1 £ ti 

IH4J 1161 


DrVS 




Maximum Independent Set 










Brute-Force 


U(n .2 ) 




MISBr 




lVlUUIl, lvlUSCt 




lfT?l 


IVllolVllvl 




Fomin, Grandoni, Kratsch 


0(1.2201") 





MISFGK 


MVC 


Minimum Vertex Cover 










Brute-Force 


0(1.47*) 




MVCBF 




Niedermeier 


IH 


MVCDBS 




Niedermeier 


0(1.33 fc ) 




MVCN 




Buss, Goldsmith 




mala 


MVCBG 


SEP 


Minimal ab-Separators 










Berry, Bordat, Cogis 


0(n 3 ) 


(a 


SEP 



Table 1: Algorithms summary 



2.1.2 Class MinDFVS 

This class is dedicated to the minimum directed feedback vertex set. This problem consists in finding the minimum 
number of vertices to delete in order to get a directed acyclic graph from a directed graph. 

Set<V> minimumDirectedAcyclicSubset(Graph<V,E> G): Computes the Minimum Directed Acyclic Subset 
as the complement of the Maximum Directed Feedback Vertex Set (see below). 

Set<V> maximumDirectedAcyclicSubset(Graph<V,E> G): The implemented method solves the problem in 

time 0(1.9977") using the Razgon work Computing Minimum Directed Feedback Vertex Set in O* (1.9977") Ifl4l0 . 
It uses kemelization techniques presented in A 4fc 2 kernel for feedback vertex set by Thomasse fl6l . 

Set<V> greedyMinFVS(Graph<V,E> G): Computes an approximation of the FVS problem using the big degree 
heuristic, written by Levorato. Starting from the initial graph, the algorithm removes the vertex with highest 
degree until the graph is acyclic. 

This class also provides a method that enumerates all the cycles. This can be usefull to find all the cycles that 
are impacted by a given vertex of the minimum feedback vertex set. 

Set<ArrayList<V> > enumAUCircuitsTarjan(Graph<V,E> G) Enumerates all circuits of a graph (Tarjan, Enu- 
meration of the elementary circuits of a directed graph II15I ). 



Algorithms 







Coloring 


MIS 


MVC 


Separators 



MarkMap 



Figure 1: The agape.algos package hierarchy 
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2.1.3 Class MIS 

This class computes the maximum independ set of a graph (directed or undirected). This problem consists in 
finding the maximum set of vertices such that two vertices of the computed set are not neighbors in the original 
graph. Several algorithms have been implemented. 

Set<V> maximalIndependentSetGreedy(Graph<V,E> g): implements a polynomial greedy heuristic in 0(n + 
m) . The algorithm chooses vertices of minimum degree and removes the neighbors iteratively. 

Set<V> maximumIndependentSetBruteForce(Graph<V,E> g): this algorithm examines every vertex subset 
and checks whether it is an independent set using the isIndependentSet method. The time complexity 
isO(> 2 .2"). 

Set<V> maximumIndependentSetMaximumDegree(Graph<V,E> g): this algorithm computes an exact solu- 
tion by branching on the maximum degree vertex that is either in or out of the final solution and computes 
the result recursively. This algorithm has been proposed by I. Todinca and M. Liedloff but has no proved 
upper bound. 

Set<V> maximumIndependentSetMoonMoser(Graph<V,E> g): the algorithm solves the problem in time 0(1.4423"). 
It is based on On cliques in graphs [ 12 1. 

Set<V> maximumIndependentSetMoonMoserNonRecursive(Graph<V,E> g): this is the non recurvisve ver- 
sion of the previous algorithm. Experimental benchmarks show that this version is slower. 

Set<V> maximuRmIndependentSetFominGrandoniKratsch(Graph<V,E> g): this method is based on A Mea- 
sure & Conquer Approach for the Analysis of Exact Algorithms |9 j. The algorithm solves the problem in 
time 0(1.2201"). 

Two methods help to detect if a set is an independent set for a given graph: 
boolean isIndependentSet(Graph<V,E> g, Set<V> S): verifies that S is an independent set of G. 

boolean isMaximalIndependentSet(Graph<V,E> g, Set<V> S): verifies that S is a maximal independent set of 
G (cannot be completed). 

2.1.4 Class MVC 

This class implements algorithms for solving the Minimum Vertex Cover problem. The problem consists in finding 
the minimum set of vertices such that any vertex is at distance at most 1 of the computed set. This class only works 
on undirected graphs. 

Set<V> twoApproximationCover(Graph<V,E> g): 2-approximation of the Minimum Vertex Cover problem. 
The algorithm returns a cover that is at most of double size of a minimal cover, 0(|i?|) time. 

Set<V> greedyCoverMaxDegree(Graph<V,E> g): this greedy heuristic computes a result by selecting itera- 
tively the vertex having the maximum degree. 

boolean kVertexCoverBruteForce(Graph<V,E> g, int k): this method selects all the sets of size k among n and 
checks if this set covers the graph. The resulting complexity is 0((^)). The algorithm tries to potentially 
select the vertices that are not covered first which improves the execution time. 

boolean kVertexCoverDegreeBranchingStrategy(Graph<V,E> g, int k): this method uses Degree-Branching- 
Strategy (DBS) and has a time complexity of 0(1.47 fc ). This algorithm is extracted from Invitation to 
Fixed-Parameter Algorithms 1131 pp. 90. 

boolean kVertexCoverNiedermeier(Graph<V,E> g, int k): this method is an implementation of Niedermeier 
algorithm of Invitation to Fixed Parameter Algorithms 1 13] pp. 99-101, which time complexity is 0(1.33 fc ). 

boolean kVertexCoverBussGoldsmith(Graph<V,E> g, int k): this method is an implementation of Buss and 
Goldsmith reduction algorithm of Nondeterminism within P [5 1, presented by Niedermeier in lfl3l pp. 54. 
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EDITING ^ || I Rectangle ■ t ] Fill LOWER ' : \ f Help 



Figure 2: Screen capture of the graph editor 



2.1.5 Class Separators 

This class implements algorithms for solving the minimal separator problem. The AB-separator problem consists 
in finding the minimum set of vertices such that removing this set of vertices disconnects the vertex A from B. 

Set<Set<V> > getABSeparators(Graph<V,E> g, V a, V b): this method computes the set of minimal ab-separator 
in 0(n 3 ) per separator. It is an implementation based on Generating All the Minimal Separators of a 
Graph 0. 

Set<Set<V> > getAUMinimalSeparators(Graph<V,E> g): this method returns all the minimal ab-separators 
for all pairs of vertices. 

2.2 Package agape.applications 

This package contain two software: a graph graphical editor and command line program that allows to launch the 
previously presented algorithms. 

2.2.1 Graphical editor: the GraphEditor class 

The graphical editor is a simple example, based on the Jung library, as shown in Figure [2] Only the possibly of 
saving a graph into a file has been added. 



2.2.2 Agape command line application: the AgapeCL class 

The command line application allows to apply an chosen algorithm to a graph or a set of graphs. All the graphs 
must be written in the . net format. This format comes from the Pajek software for social network analysis. A 
. net file is composed of the list of vertices and the adjacency list. An example of a Pajek file is presented in 



Listing 2.2.2 The graph is composed of 4 vertices and 4 edges (a,b), (b,c), (b,d), and (c,d). 



The AgapeCL command line application can be used with the standalone package distributed on the website: 
java -jar AgapeCL. jar graphFilePath | graphDirectoryPath algorithm 

The first parameter is the name of the .net file (or the directory that contains multiple files) and the second 
one is the algorithm name that has to be chosen among CN, MISBF, MISMM, MISDegMax, MISFGK, MVCBF, 
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Example of .net file 

♦Vertices 4 

1 "a" 

2 "b" 

3 "c" 

4 "d" 

*edgeslist 
l 2 

234 
34 



MVCBG, MVCDBS, MVCN, DFVS, SEP that correspond to the algorithm of Table[T] The two following listings 
show examples of execution. 



Example of execution on test.net 
java -jar AgapeCL.jar ../test. net MISFGK 

V:50 E:238 
660.0 ms 
Size: 14 

[vO, v48, v17, v18, v36, v6, v25, v13, v9, 
v40, v34, v44, v31 , v32] 



Example of execution on a directory 

java -jar AgapeCL.jar . . /GenGraphs/temp/ 
MISFGK 

I6cell.net 

V:8 E:24 
3 6.0 ms 
Size : 2 

[3, 2] 



snark. net 

V:12 E:15 
5.0 ms 
Size : 6 

[2, 10, 0, 5, 8, 11] 



thomassen20 . net 

V:20 E:37 
18.0 ms 
Size: 8 

[1, 6, 19, 4, 17, 9, 14, 11] 



2.3 Package agape. generators 

This package contains several graph generators. Two categories of generators have been implemented: random 
and non random generators. Some generators are based on Jung generators and others have been implemented 
from scratch. Below is listed all the available generators. All the generators need factories to instantiate vertices 
and edges. 

2.3.1 Random graph generators 

• Erdos Renyi random graphs [8 1. 

• Eppstein random graphs (from Jung) |7). 

• Barabasi-Albert random graphs (from Jung) J2j- 

• Kleinberg small world graphs iflOl . 

• Watts-Strogatz small world graphs fPTl . 

• k-regular random graphs. 
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2.3.2 Structured graph generators 

See Section [3.1.4| for an example of use of these two generators. 

• 2D grids. 

• K-regular rings. 

In order to use the generators, the user has to define first a graph factory before using one of the generators. A 



tutorial about factories is presented in Section 3.1.3 



2.4 Package agape.io 

This package contains two classes for the read/write operation on graphs (Import and Export). 
Formats supported for reading: 

• .net oriented or non oriented (Pajek) |6 1. 

• . mql Mascopt ifTTl . 

• . t g f Wolfram Mathematica |http : / /www . wolfram, com/mat hematica/| 
Formats supported for writting: 

• .net oriented or non oriented (Pajek) [6 1. 

• . gv Graph Viz|http : / / www . graphviz . org/| 



A tutorial about input/output is presented in section 3.1.2 



2.5 Package agape.tools 

This package is a set of toolboxes for classical graph operations. In the Operations class, we implemented 
metric detection (diameter, degrees, . . . ), type identification (clique, regular, simple edge, . . . ), copy operations 
(copy, merge, subgraphs, . . . ), ... For example, the getMinDeg (Graph<V, E> g) returns the vertex that has 
the smallest degree and isRegular (Graph<V, E> gtest if the graph is k-regular. In the Components class, 
we implemented methods for connected components of a graph, for example the Tarjan's method that computes 
all the strongly connected components in getAHStronglyConnectedComponent (Graph<V, E> g. 



2.6 Package agape. visualization 

This package contains the class Visualization that provides a method to display a graph (showGraph) and a 
method to represent a graph as a B-matrix (TJ, as shown in Figure[3] 
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Figure 3: B-matrix for a Watts-STrogatz small world 



3 Tutorials 



3.1 Tutorials for basics 
3.1.1 Creating Jung graphs 

Jung graphs are easy to build using templated classes such as DirectedSparseGraph. Vertices and edges are 
java objects that are manipulated by the Jung class graphs. 



Tutorial : ag ape . tutori al s . JungGraphTutorial 

/* 

* Copyright University of Orleans — ENSI de Bourges. 

* Source code under CeCILL license. 

*/ 

package agape.tutorials; 

import edu.uci.ics.jung.graph. DirectedSparseGraph; 
import edu.uci.ics.jung.graph.util.Pair; 

public class JungGraphTutorial { 

public static void main(String[] args) ( 

DirectedSparseGraph<String, lnteger> g = new 
DirectedSparseGraph<String, lnteger>(); 
g.addVertex("n1"); 
g.addVertex("n2"); 
g.addVertex("n3"); 

// Jung finds matching nodes even if pointers are different 

g.addEdge(l, new Pair<String>("n1", "n2")); 
System.out.println(g); 

// Jung adds automatically new nodes 

g.addEdge(2, new Pair<String>("n1", "n4")); 
System. out.println(g); 
g.removeVertex("n1"); 
System.out.println(g); 




Tutorial: console output 

Vertices:n1,n3,n2 

Edges:l[n1,n2] 

Vertices:n1,n4,n3,n2 

Edges:l[n1,n2] 2[n1,n4] 

Vertices:n4,n3,n2 

Edges: 



9 



3. 1 Tutorials for basics 



P. Berthome, J.-F. Lalande, V. Levorato 



3.1.2 Input/Output 

A .net reader have been implemented in the class Import. The first line of the file is ignored (title), then each 
line is parsed to read vertices (name "label") until the string *edgeslist is found. Then, the edges/arcs are read 
until the end. The .net file instanciates Graph<String, Integer> which implies that vertices are String 
and edges/arcs are Integer. Exporting a graph to a file works the same way. The Export class can also write 
files using the graphviz format. 



Tutorial : ag ape . tutori al s . IOTutorial 



* Copyright University of Orleans — ENSI de Bourges. 

* Source code under CeCILL license. 

*/ 

package agape.tutorials; 

import java.io.lOException; 

import agape. io.Export; 
import agape. io.lmport; 
import edu.uci.ics.jung.graph.Graph; 



Tutorial: IOTutorial.net 



* ©author jf 

*/ 

public class IOTutorial { 
public static void main(String[] args) ( 
Graph<String.lnteger> g = Import.readDNetC'src/agape/tutorials/ 

IOTutorial.net"); 
System.out.println(g); 
try { 

Export.writeGV("src/agape/tutorials/IOTutorial", g); 
) catch (lOException e) ( 
e.printStackTrace(); 

I 

) 



* Vertices 4 

1 "a" 

2 "b" 

3 "C" 

4 "d" 

*edgeslist 

1 2 

234 

34 



Tutorial: IOTutorial. gv 



digraph G ( 
size="1 00,20"; ratio 
node [style=filled]; 



= auto; 



-> "b" [color="0.649 0.701 0.701"] 
-> "c" [color="0.649 0.701 0.701 "] 
-> "d" [color="0.649 0.701 0.701"] 
-> "d" [color="0.649 0.701 0.701"] 
[color=grey] 



1 [color=grey] 
"c" [color=grey] 
"a" [color=grey] 
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3.1.3 Using factories 

Several algorithms, especially the developed generators use factories to create new graphs. Indeed, the algorithm 
does not know the real type of the graph that implements the Jung interface. For example, a graph that has 
vertices based on String and edges on Integer, is typed as Graph<String, Integer>. The definition 
of factories is based on the interface Factory of apache's commons that needs to be instanciated with the 
choosen type: in order to build a new MyFactory<String> () , MyFactory must implement the create 
() method. 



Tutorial : agape .tutorials . UsingFactoriesTutorial 

/* 

* Copyright University of Orleans — ENSI de Bourges. 

* Source code under CeCILL license. 

*/ 

package agape.tutorials; 

import org.apache.commons.collectionsl 5. Factory; 

import agape.generators.RandGenerator; 

import agape.visu. Visualization; 

import edu.uci.ics.jung.graph.Graph; 

import edu.uci.ics.jung.graph.UndirectedSparseGraph; 

public class UsingFactoriesTutorial { 
public static void main(String[] args) ( 

Factory<lnteger> edgeFactory = new Factory<lnteger>() ( 
int c=0; 

public Integer createo { 
C++; 

return Integer.valueOf(c); 

) 

}; 

Factory<String> vertexFactory = new Factory<String>() ( 
int C=0; 

public String create') { 
C++; 

return "v"+C; 

) 

}; 

Factory<Graph<String,lnteger» graphFactory = new Factory< 
Graph<String,lnteger»() ( 
public Graph<String,lnteger> create') { 
return new UndirectedSparseGraph<String, lnteger>(); 

) 

}; 

FiandGenerator<String, lnteger> generator = new RandGenerator< 

String, lnteger>(); 
Graph<String. Integer> g = generator.generateErdosRenyiGraph( 

graphFactory, vertexFactory, edgeFactory, 10, 3); 
System.out.println(g); 

Visualization. showGraph(g); 



Tutorial: console output 

Vertices;v1 ,v7,v5,v6,v4,v9,v3,v8,v2,v1 

Edges: I[v1,v7] 2[v1,v5] 3[v1,v6] 4[v1,v4] 5[v1,v9] 6[v1,v3] 7[v1,v8] 8[v1 
,v2] 9[v1,v10] 10[v7,v5] Il[v7,v6] 12[v7,v4] 13[v7,v9] 14[v7,v3] 
15[v7,v8] I7[v7,v10] 16[v7,v2] 19[v5,v4] 18[v5,v6] 21[v5,v3] 20[v5 
,v9] 23[v5,v2] 22[v5,v8] 25[v6,v4] 24[v5,v10] 27[v6,v3] 26[v6,v9] 
29[v6,v2] 28[v6,v8] 31[v4,v9] 30[v6.v10] 34[v4,v2] 35[v4,v10] 32[ 
v4,v3] 33[v4,v8] 38[v9,v2] 39[v9,v10] 36[v9,v3] 37[v9,v8] 42[v3, 
v10] 43[v8,v2] 40[v3,v8] 41[v3,v2] 44[v8,v10] 45[v2,v10] 




V2 



vlO v5 
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As a consequence, some operations have been implemented using factories. For example, the copyGraph 
method asks for a factory in order to copy any kind of graph, as shown in the example below. Furthermore, many 
algorithms need to manipulate deeply graphs by creating, deleting edges and/or vertices. These algorithms thus 
require the adequate factories to complete. 

Tutori al : ag ape . tutori al s . Copy GraphTutori al 

/* 

* Copyright University of Orleans — ENSI de Bourges. 

* Source code under CeCILL license. 

*/ 

package agape.tutorials; 

import agape.tools.Operations; 

import edu.uci.ics.jung.graph.SparseGraph; 

import edu.uci.ics.jung.graph.UndirectedSparseGraph; 

import edu.uci.ics.jung.graph.util.Pair; 

public class CopyGraphTutorial { 

public static void main(String[] args) { 

System.out.println(" "); 

System. out. println("UNDIRECTED GRAPH"); 

System, out.printlnf" "); 

SparseGraph<String, lnteger> gu = new SparseGraph<String, 
lnteger>(); 

UndirectedGraphFactoryForStringlnteger undfactory = new 
UndirectedGraphFactoryForStringlntegerQ; 

gu.addVertex("n1"); gu.addVertex("n2"); 
gu.addVertex("n3"); gu.addVertex("n4"); 
gu.addVertex("n5"); 

gu.addEdge(l, new Pair<String>("n1", "n2")); 
gu.addEdge(2, new Pair<String>("n1", "n4")); 
gu.addEdge(3, new Pair<String>("n2", "n3")); 
gu.addEdge(4, new Pair<String>("n3", "n5")); 
gu.addEdge(5, new Pair<String>("n5", "n2")); 
gu.addEdge(6, new Pair<String>("n5", "n3")); // useless 

/* This is an explicit call to the copyUndirectedSparseGraph method 

* (we know that the graph is undirected) 

*/ 

System. out.println(gu); 

UndirectedSparseGraph<String. Integer> gu2 = 

(UndirectedSparseGraph<String, lnteger>) Operations. 
copyUndirectedSparseGraph(gu); 
System.out.println(gu2); 

/* This is a general call to the copyGraph method that uses a factory 

* (we do not want to know if the graph is direted or not) 

*/ 

UndirectedSparseGraph<String. Integer> gu3 = 

(UndirectedSparseGraph<String. Integer>) Operations. 
copyGraph(gu, undfactory); 
System.out.println(gu3); 
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Using factories may cause issues when graphs are created manually because there may be conflicts between 
the generated vertices/edges and the already existing ones. The following example shows such a conflict. To solve 
the issue, the user should create any graph using the factory that is used later in the algorithms. 



Tutorial : agape .tutorials . Factory Problem 

/* 

* Copyright University of Orleans — ENSI de Bourges. 

* Source code under CeCILL license. 

*/ 

package agape.tutorials; 
import java.util. Iterator; 

import org.apache.commons.collectionsl 5. Factory; 

import edu.uci.ics.jung.graph.Graph; 
import edu.uci.ics.jung.graph.SparseGraph; 
import edu.uci.ios.jung.graph.util.Pair; 

public class FactoryProblem<V.E> { 

/** 

* @param args 
*/ 

public static void main(String[] args) ( 

// Creating the graph and the corresponding factory 
UndirectedGraphFactoryForStringlnteger undfactory = new 
UndirectedGraphFactoryForStringlntegerQ; 

SparseGraph<String, lnteger> gu = new SparseGraph<String, 

lnteger>(); 
gu.addVertex("v1 "); gu.addVertex("v2"); 
gu.addVertex("v3"); gu.addVertex("v4"); 
gu.addVertex("v5"); 

gu.addEdge(l, new Pair<String>("v1 ", "v2")); 
gu.addEdge(2. new Pair<String>("v1 ", "v4")); 
gu.addEdge(3, new Pair<String>("v2", "v3")); 
gu.addEdge(4, new Pair<String>("v3", "v5")); 
gu.addEdge(5, new Pair<String>("v5", "v2")); 
gu.addEdge(6, new Pair<String>("v5", "v3")); 

FactoryProblem<String, lnteger> problem = new 
FactoryProblem<String, lnteger>(); 

try 
( 

problem.addRandomEdge(gu, undfactory.edgeFactory); 

} 

catch (UlegalArgumentException e) 

{ 

System.err.println(e); 

System.out.println("Our factory is badly used because it 
tries to instantiate the edge number 1 " + 
"which already exists in the graph."); 

} 

// Solution: we should not have created the graph manually ! 
SparseGraph<String, lnteger> gu2 = new SparseGraph<String, 

lnteger>(); 
String v[] = new String[5]; 



for (hit i=0; i<5; i++) 
{ 

v[i] = undfactory.vertexFactory.createO; 
gu2.addVertex(v[i]); 

} 

Integer e[] = new lnteger[6]; 

for (int i=0; i<6; i++) 

e[i] = undfactory.edgeFactory.create(); 
gu2.addEdge(e[0], v[0], v[l]) ; 
gu2.addEdge(e[l], v[0], v[3]) ; 
gu2.addEdge(e[2], v[l], v[2]) ; 
gu2.addEdge(e[3], v[2], v[4]) ; 
gu2.addEdge(e[4], v[4], v[2]) ; 
gu2.addEdge(e[5], v[4], v[3]) ; 

System. out.println("gu2 before : " + gu2); 
problem.addRandomEdge(gu2. undfactory.edgeFactory); 
System. out.println("gu2 after : " + gu2); 

} 

public void addRandomEdge(Graph<V, E> g, Factory<E> f) 
{ 

// Choosing 2 vertices 

int choice = (int)(Math.random()*g.getVertexCount()) ; 
lterator<V> it = g.getVertices().iterator(); 

V v1 = null; 

for (int i = 0; i <= choice; i++) 

v1 = it.nextO; 

choice = (int)(Math.random()*g.getVertexCount()) ; 
it = g.getVertices().iterator(); 

V v2 = null; 

for (int i = 0; i <= choice; i++) 
v2 = it.nextO; 

E edge = f.create(); 

System. out.println("Trying to add Edge " + edge + " between " + 

v1 + " " + v2); 
g.addEdgefedge, v1, v2); 




Tutorial: console output 
Trying to add Edge 1 between v4 v3 

java.lang. UlegalArgumentException: edge l already exists in this graph 
with endpoints <v1 , v2> and cannot be added with endpoints <v4, 
v3> 

Our factory is badly used because it tries to instantiate the edge number 

l which already exists in the graph. 
gu2 before : Vertices;v1 ,v5,v4,v3,v2 
Edges:2[v1 ,v2] 3[v1 ,v4] 4[v2,v3] 5[v3,v5] 7[v5,v4] 
Trying to add Edge 8 between v2 v4 
gu2 after : Vertices:v1 ,v5,v4,v3,v2 

Edges:2[v1 ,v2] 3[v1 ,v4] 4[v2,v3] 5[v3,v5] 7[v5,v4] 8[v2,v4] 
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3.1.4 Using generators 



Tutorial: agape. tutorials. NRandomGeneratorTutorial Tutorial: agape. tutorials. RandomGeneratorTutorial 



* Copyright University of Orleans — ENSI de Bourges. 

* Source code under CeCILL license. 

*/ 

package agape.tutorials; 

import agape.generators.NRandGenerator; 
import agape.visu. Visualization; 
import edu.uci.ics.jung.algorithms.layout.CircleLayout; 
import edu.uci.ics.jung.graph.Graph; 

public class NRandomGeneratorTutorial ( 
public static void main(String[] args) ( 

DirectedGraphFactoryForStringlnteger factory = new 
DirectedGraphFactoryForStringlnteger(); 

Graph<String, lnteger> g = NRandGenerator.generateRegularRing( 

factory. factory.vertexFactory. factory.edgeFactory. 20, 6); 
Visualization. showGraph(g, new Circlel_ayout<String,lnteger>(g)); 

Graph<String. Integer> g2 = NRandGenerator.generateGridGraph( 
factory, factory.vertexFactory, factory.edgeFactory, 3, 5, false) 

Visualization. showGraph(g2); 




* Copyright University of Orleans — ENSI de Bourges. 

* Source code under CeCILL license. 

*/ 

package agape.tutorials; 

import agape.generators.RandGenerator; 

import agape.visu. Visualization; 

import edu.uci.ics.jung.algorithms.layout.CircleLayout; 

import edu.uci.ics.jung.graph.Graph; 

public class RandomGeneratorTutorial ( 

public static void main(String[] args) throws Exception ( 

UndirectedGraphFactoryForStringlnteger factory = new 
UndirectedGraphFactoryForStringlnteger(); 

Graph<String, lnteger> g2 = RandGenerator. 
generateKleinbergSWGraph( 
factory, factory.vertexFactory, factory.edgeFactory, 5, 5, 

1, 2, 2); 

Visualization.showGraph(g2); 

Graph<String, lnteger> g3 = RandGenerator. 
generateWattsStrogatzSWGraph( 
factory. factory.vertexFactory. factory.edgeFactory, 24, 

4, 0.5); 

Visualization.showGraph(g3, new CircleLayout<String,lnteger>( 
g3)); 

Graph<String, lnteger> g4 = RandGenerator. 
generateErdosRenyiGraph( 
factory, factory.vertexFactory, factory.edgeFactory, 10, 

0.5); 

Visualization.showGraph(g4); 

Graph<String. Integer> g5 = RandGenerator. 
generateBarabasiAlbertGraph( 
factory. factory.vertexFactory. factory.edgeFactory, 10, 

5,7); 

Visualization.showGraph(g5); 

Graph<String, lnteger> g6 = RandGenerator. 
generateEppsteinGraph( 
factory, factory.vertexFactory, factory.edgeFactory, 10, 
25, 100); 
Visualization.showGraph(g6); 

Graph<String. Integer> g7 = RandGenerator. 
generateRandomRegularGraph( 
factory, factory.vertexFactory, factory.edgeFactory, 10, 

5); 

Visualization.showGraph(g7); 
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3.2 Tutorials for algorithms 



P. Berthome, J.-F. Lalande, V. Levorato 



3.2 Tutorials for algorithms 
3.2.1 Using Coloring algorithms 

After generating a graph using one of the factories, this example shows how to compute the chromatic number of 
a graph using the Coloring class. 



Tutorial: agape. algos. Coloring 

/* 

* Copyright University of Orleans — ENSI de Bourges. 

* Source code under CeCILL license. 

*/ 

package agape.tutorials; 

import java.util. Set; 

import agape.algos.Coloring; 
import agape.generators.RandGenerator; 
import agape.visu. Visualization; 
import edu.uci.ics.jung.graph.Graph; 

public class AlgoColoringTutorial ( 
public static void main(String[J args) ( 

UndirectedGraphFactoryForStringlnteger factory = new 
UndirectedGraphFactoryForStringlnteger(l.l); 
RandGenerator<String, lnteger> generator = new RandGenerator< 

String, lnteger>(); 
Graph<String. Integeo g = generator.generateErdosRenyiGraph( 
factory, factory.vertexFactory, factory.edgeFactory, 9, 0.7); 
System.out.println("Generating an Erdos Renyi graph:"); 
System.out.println(g); 



Coloring<String,lnteger> coloring = new Coloring<String, lnteger>( 
factory); 

int col = coloring.chromaticNumber(g); 
System.out.println("Chromatic number: " + col); 

Set<Set<String» sol = coloring.graphColoring(g); 
System.out.println(sol); 

Visualization. showGraphSets(g, sol); 



Graph<String. Integer> g2 = generator.generateErdosRenyiGraph( 
factory. factory.vertexFactory. factory.edgeFactory, 90, 0.05); 

System.out.println("Graph2: " + g2.getVertexCount() + " vertices, " + 
g2.getEdgeCount() + " edges."); 

Set<Set<String» sol2 = coloring.greedyGraphColoring(g2); 

System.out.println("Greedy chromatic number: " + sol2.size()); 

Visualization. showGraphSets(g2, sol2); 

) 

} 



Tutorial: console output 

Generating an Erdos Renyi graph: 
Vertices;v1,v7,v5,v6,v4,v9,v3,v8,v2 

Edges: I[v1,v9] 2[v1,v3] 3[v1,v8] 4[v1,v2] 5[v7,v5] 6[v7,v6] 7[v7,v8] 8[v7 
,v2] 

9[v5,v4] 10[v5,v9] Il[v5,v3] 12[v5,v8] 13[v5,v2] 14[v6,v9] 15[v6,v3] 17[ 
v6,v2] 

16[v6,v8] 19[v4,v8] 18[v4,v3] 21[v9,v3] 20[v4,v2] 23[v3,v2] 22[v3,v8] 

Chromatic number: 4 

[[v5], [v7, v3], [v1 , v4, v6], [v9, v2, v8]] 

Graph2: 90 vertices, 188 edges 

Greedy chromatic number: 6 
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3.2.2 Using MinDFVS algorithms 

After generating a graph using one of the factories, this example shows how to compute the minimum directed 
feedback vertex set. 



Tutorial: agape. algos. MinDFVS 



* Copyright University of Orleans — ENSI de Bourges. 

* Source code under CeCILL license. 

*/ 

package agape.tutorials; 

import java.util.ArrayList; 
import java.util. Set; 

import agape.algos.MinDFVS; 

import agape.visu. Visualization; 

import edu.uci.ics.jung.graph.DirectedSparseGraph; 

import edu.uci.ics.jung.graph.util.Pair; 

public class AlgoDFVSTutorial j 

public static void main(String[] args) ( 

DirectedGraphFactoryForStringlnteger factory = new 
DirectedGraphFactoryForStringlnteger(); 

DirectedSparseGraph<String, lnteger> g = new 
DirectedSparseGraph<String, lnteger>(); 

g.addVertex("n1"); g.addVertex("n2"); 
g.addVertex("n3"); g.addVertex("n4"); 
g.addVertex("n5"); g.addVertex("n6"); 
g.addVertex("n7"); g.addVertex("n8"); 



Tutorial: console output 



g.addEdge(l. 
g.addEdge(2. 
g.addEdge(3. 
g.addEdge(4. 
g.addEdge(5. 
g.addEdge(6. 
g.addEdge(7. 
g.addEdge(8. 
g.addEdge(9. 
g.addEdge(lO 
g.addEdge(ll 



new Pair<String>("n1". 
new Pair<String>("n1", 
new Pair<String>("n2". 
new Pair<String>("n3". 
new Pair<String>("n5", 
new Pair<String>("n5". 
new Pair<String>("n4", 
new Pair<String>("n4", 
new Pair<String>("n8". 
new Pair<String>("n7' 
new Pair<String>("n3' 



"n2")); 

"n4")); 

"n3"»; 

"n5")); 

"n2")); 

"n3")); 

"n6")); 

"n7")); 

"n1"»; 

, "n8")); 

,"n1")); 



Vertices:n1,n5,n4,n3,n2,n8,n7,n6 

Edges:l[n1,n2] 2[n1,n4] 3[n2,n3] 4[n3,n5] 5[n5,n2] 6[n5,n3] 7[n4,n6] 8[ 

n4,n7] 9[n8,n1] 10[n7,n8] Il[n3,n1] 
Circuits: [[n5, n3], [n5, n2, n3], [n1, n4, n7, n8], [n1, n2, n3]] 
Max directed acyclic subset: [n1 , n5, n4, n2, n8. n6] 
Greedy directed acyclic subset:[n1 , n5] 
Min directed acyclic subset: [n3, n7] 




System. out.println(g); 

MinDFVS<String, lnteger> dfvs = new MinDFVS<String, Integer 
>(factory, factory.edgeFactory); 

Set<ArrayList<String» circuits = dfvs.enumAIICircuitsTarjan(g); 
System.out.println("Circuits: " + circuits); 

Set<String> subset = dfvs.maximumDirectedAcyclicSubset(g); 
System. out.println("Max directed acyclic subset: " + subset); 

Set<String> subset3 = dfvs.greedyMinFVS(g); 

System. out.printlnC'Greedy directed acyclic subset:" + subset3) 



Set<String> subsetComplementary = dfvs. 

minimumDirectedAcyclicSubset(g); 
System. out.printlnC'Min directed acyclic subset: " + 

subsetComplementary); 

Visualization.showGraph(g, subsetComplementary); 

) 

) 
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3.2.3 Using MIS algorithms 

This example shows to how compute the minimum independent set. 



Tutorial: agape. algos. MIS 

/* 

* Copyright University of Orleans — ENSI de Bourges. 

* Source code under CeCILL license. 

*/ 

package agape.tutorials; 

import java.util. Set; 

import agape.algos.MIS; 

import agape.visu. Visualization; 

import edu.uci.ics.jung.graph.DirectedSparseGraph; 

import edu.uci.ics.jung.graph.util.Pair; 

public class AlgoMISTutorial { 

public static void main(String[] args) ( 

DirectedGraphFactoryForStringlnteger factory = new 
DirectedGraphFactoryForStringlnteger(); 

DirectedSparseGraph<String, lnteger> g = new 
DirectedSparseGraph<String, lnteger>(); 
g.addVertex("n1"); g.addVertex("n2"); 
g.addVertex("n3"); g.addVertex("n4"); 
g.addVertex("n5"); 

g.addEdge(l, new Pair<String>("n1", "n2")); 
g.addEdge(2, new Pair<String>("n1", "n4")); 
g.addEdge(3, new Pair<String>("n2". "n3")); 
g.addEdge(4, new Pair<String>("n3", "n5")); 
g.addEdge(5, new Pair<String>("n5", "n2")); 
g.addEdge(6, new Pair<String>("n5", "n3")); 

System.out.println(g); 

Set<String> set = null; 

MIS<String, lnteger> mis = new MIS<String, lnteger>(factory. 
factory.vertexFactory, factory.edgeFactory); 

set = mis.maximallndependentSetGreedy(g); 
System. out.printlnC'Greedy result; " + set); 

set = mis.maximuRmlndependentSetFominGrandoniKratsch(g); 
System.out.println("FominGrandoniKratsch: " + set); 

set = mis.maximumlndependentSetMaximumDegree(g); 
System.out.println("Branching on Maximum Degree: " + set); 

set = mis.maximumlndependentSetMoonMoser(g); 
System.out.println("Moon Moser result: " + set); 

set = mis.maximumlndependentSetMoonMoserNonRecursive(g 

); 

System.out.println("Moon Moser (non recursive) result: " + set); 
Visualization.showGraph(g, set); 

) 

} 



Tutorial: console output 
Vertices;n1 ,n5,n4,n3,n2 

Edges:l[n1,n2] 2[n1,n4] 3[n2,n3] 4[n3,n5] 5[n5,n2] 6[n5,n3] 

Greedy result: [n4, n2] 

FominGrandoniKratsch: [n1, n5] 

Branching on Maximum Degree: [n1, n5] 

Moon Moser result: [n1, n5] 

Moon Moser (non recursive) result: [n4, n2] 
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3.2.4 Using MVC algorithms 

This example shows computations of the minimum vertex cover for undirected graphs. 



Tutorial: agape. algos. MVC 



* Copyright University of Orleans — ENSI de Bourges. 

* Source code under CeCILL license. 

*/ 

package agape.tutorials; 

import agape.algos.MVC; 

import agape.visu. Visualization; 

import edu.uci.ics.jung.graph.SparseGraph; 

import edu.uci.ics.jung.graph.util.Pair; 

public class AlgoMVCTutorial { 

public static void main(String[] args) ( 



System. out.println(" "); 

System.out.println("UNDIRECTED GRAPH"); 
System. out.println(" "); 



Tutorial: console output 



SparseGraph<String, lnteger> gu = new SparseGraph<String, 
lnteger>(); 

UndirectedGraphFactoryForStringlnteger undfactory = new 
UndirectedGraphFactoryForStringlnteger(); 



gu.addVertex("n1"); gu.addVertex("n2") 
gu.addVertex("n3"); gu.addVertex("n4") 
gu.addVertex("n5"); gu.addVertex("n6") 
gu.addVertex("n7"); gu.addVertex("n8") 



gu.addEdge(l, new Pair<String>("n1", "n2")); 
gu.addEdge(2, new Pair<String>("n1", "n4")); 
gu.addEdge(3. new Pair<String>("n2", "n3")); 
gu.addEdge(5, new Pair<String>("n5", "n2")); 
gu.addEdge(7, new Pair<String>("n1", "n6")); 
gu.addEdge(9. new Pair<String>("n1", "n7")); 
gu.addEdge(ll, new Pair<String>("n2", "n8")); 

System. out.println(gu); 

MVC<String, lnteger> mvc = new MVC<String, lnteger>( 
undfactory); 

mvc.twoApproximationCover(gu); 
System.out.println("result 2-approx: " + mvc. 
getvertexCoverSolutionO); 

mvc.greedyCoverMaxDegree(gu); 
System. out.println("result greedy: " + mvc. 
getvertexCoverSolutionO); 

mvc.kVertexCoverBruteForce(gu, 2); 
System.out.println("result BruteForce k=2: " + mvc. 
getvertexCoverSolutionO); 

mvc.kVertexCoverBruteForce(gu, 3); 
System. out.println("result BruteForce k=3: " + mvc. 
getvertexCoverSolutionO); 

mvc.kVertexCoverBruteForce(gu, 4); 
System.out.println("result BruteForce k=4: " + mvc. 
getvertexCoverSolutionO); 

mvc.kVertexCoverDegreeBranchingStrategyfgu, 2); 
System. out.println("result DegreeBranching k=2; " + mvc. 
getvertexCoverSolutionO); 

mvc.kVertexCoverBussGoldsmith(gu, 2); 
System. out.println("result Buss k=2: " + mvc. 
getvertexCoverSolutionO); 

mvc.kVertexCoverNiedermeier(gu, 2); 
System.out.println("result Niedermeier k=2: " + mvc. 
getvertexCoverSolutionO); 

Visualization.showGraph(gu, mvc.getVertexCoverSolutionO); 



UNDIRECTED GRAPH 



Vertices;n1,n5,n4,n3,n2,n8,n7,n6 

Edges:l[n1,n2] 2[n1,n4] 3[n2,n3] 5[n5,n2] 7[n1,n6] 9[n1,n7] Il[n2,n8] 

result 2-approx: [n1,n2] 

result greedy: [n1, n2] 

result BruteForce k=2: [n1 , n2] 

result BruteForce k=3: [n1 , n5, n2] 

result BruteForce k=4: [n1 , n5, n3, n8] 

result DegreeBranching k=2: [n1, n2] 

result Buss k=2: [n1, n2] 

result Niedermeier k=2: [n1 , n2] 
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3.2.5 Using Separators algorithms 

This example shows how to compute the minimum separators of two vertices. 



Tutorial: agape. algos. Separators 

/* 

* Copyright University of Orleans — ENSI de Bourges. 

* Source code under CeCILL license. 

*/ 

package agape.tutorials; 

import java.util.HashSet; 
import java.util. Set; 

import agape.algos.Separators; 

import agape.visu. Visualization; 

import edu.uci.ics.jung.graph.SparseGraph; 

import edu.uci.ics.jung.graph.util.Pair; 

public class AlgoSeparatorsTutorial { 
public static void main(String[] args) ( 

Separators<String, lnteger> sep = new Separators<String. 
Integer>(); 

System.out.println(" "); 

System. out. println("UNDIRECTED GRAPH"); 
System.out.println(" "); 

SparseGraph<String, lnteger> gu = new SparseGraph<String, 
lnteger>(); 

gu.addVertex("n1"); gu.addVertex("n2"); 
gu.addVertex("n3"); gu.addVertex("n4"); 
gu.addVertex("n5"); gu.addVertex("n6"); 

gu.addEdge(l, new Pair<String>("n1", "n2")); 
gu.addEdge(2, new Pair<String>("n1", "n4")); 
gu.addEdge(3, new Pair<String>("n2", "n3")); 
gu.addEdge(4, new Pair<String>("n3", "n5")); 
gu.addEdge(5, new Pair<String>("n5", "n2")); 
gu.addEdge(6, new Pair<String>("n1", "n6")); 
gu.addEdge(7. new Pair<String>("n5", "n6")); 

System. out.println(gu); 

Set<Set<String» set = sep.getABSeparatorsfgu, "n4", "n3"); 
System.out.println("n4/n5: " + set); 

set = sep.getAIIMinimalSeparators(gu); 
System.out.println("all minimum separators: " + set); 

set = sep.getABSeparators(gu, "n1 ", "n5"); 
System.out.println("n1/n5: " + set); 

HashSet<String> toSeparate = new HashSet<String>(); 

toSeparate.add("n1"); 

toSeparate.add("n5"); 

Visualization.showGraph(gu, set.iterator().next(), toSeparate); 




Tutorial: console output 



UNDIRECTED GRAPH 



Vertices;n1 ,n5,n4,n3,n2,n6 

Edges:l[n1,n2] 2[n1,n4] 3[n2,n3] 4[n3,n5] 5[n5,n2] 6[n1,n6] 7[n5,n6] 
n4/n5; [[n1], [n2, n6], [n5, n2]] 

all minimum separators: [[n1 ], [n2, n6], [n5, n2], [n1 , n5]] 
n1/n5: [[n2, n6]] 




n 3 
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